home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 10 / The PC-Sig Library - Shareware for the IBM PC and Compatibles (PC-SIG)(Tenth Edition Disks 1-2804)(1991).iso / PC_SIGCD / 02 / 8 / DISK0283.ZIP / DTK.DOC < prev    next >
Text File  |  1986-11-09  |  9KB  |  346 lines
  1.                        ╔═══════════════════════════╗
  2.                        ║     Directory Toolkit     ║
  3.                        ║(C) 1984  By Gary W. Morris║
  4.                        ║      3317 Columbine       ║
  5.                        ║   Lebanon, Oregon 97355   ║
  6.                        ║       503-259-1462        ║
  7.                        ╚═══════════════════════════╝
  8.            This Program was written in order to fill several needs which I
  9.  
  10.       had. One need was to have a good way to keep track of what was on a
  11.  
  12.       disk. A very good Label printing program called `Diskette Manager'
  13.  
  14.       was just what the doctor ordered except for one thing -- it only
  15.  
  16.       served one of my needs. Another need was to allow me to add or change
  17.  
  18.       the Volume label on a Disk after it had been formatted. Several
  19.  
  20.       programs allow this function (Volser.com - a public domain program,
  21.  
  22.       and Label.com by Peter Norton, just to name two) but again it only
  23.  
  24.       served one of my needs and more importantly I wanted some unique
  25.  
  26.       utilities that were MENU driven.
  27.  
  28.            Several other utilities (Change Attributes, Sort Directory,
  29.  
  30.       Display a `RUN MENU ') are also available , But WHERE could I get
  31.  
  32.       them all on one Menu-Driven Disk ?  Probably the most Unique utility
  33.  
  34.       on my DIRECTORY TOOLKIT Disk is the one that easily allows you to
  35.  
  36.       change the Date and Time-Stamp of each file. Norton describes the
  37.  
  38.       usefulness of this utility on page 43 of his Utilities under the
  39.  
  40.      `SecMod' Command. But it is not something that is easily done unless
  41.  
  42.       you are willing to decode the 16 bit unsigned integer,as I was, and
  43.  
  44.       then change the correct sector location on the disk. Not something
  45.  
  46.       easy for most programmers.
  47.  
  48.            So because of the reasons above I wrote this set of MENU-DRIVEN
  49.  
  50.       Utilities that allows editing by placing the cursor on the old data.
  51.  
  52.       Many thanks to Brett Salter for his help and his fine set of Programs
  53.  
  54.      `Peeks n Pokes' and `The Inside Track' without which these utilities
  55.  
  56.       would have been much more difficult.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                         -2-
  73.  
  74.  
  75.  
  76.            There are currently 9 options on the MENU and although all of
  77.  
  78.       them are pretty much self explanatory, I will say a few words about
  79.  
  80.       each.
  81.  
  82.  
  83.        OPTION ( 1 ) - Display `Run Menu' for all (*.bas) Programs.
  84.  
  85.            This option allows you to have a Menu of all the basic programs
  86.  
  87.            on any disk and be able to Load and run them without having to
  88.  
  89.            enter the file name. Just enter the correct file number and it
  90.  
  91.            will be loaded and run. You may want to add a `Run A:DTK.BAS'
  92.  
  93.            line to the other programs that you run frequently to return to
  94.  
  95.            this utility. (Can LOAD and RUN On MS-BASIC version ONLY)
  96.  
  97.        OPTION ( 2 ) - Display Complete Directory (File Names Only).
  98.  
  99.            This option allows you to see all files including hidden and the
  100.  
  101.            Volume-Id up to 105 at a time. No attributes,file size or any
  102.  
  103.            other information is displayed.
  104.  
  105.        OPTION ( 3 ) - Display/Edit Filenames,Attributes,Date-Stamp.
  106.  
  107.            This option allows you to:
  108.  
  109.                 ( a ) - Rename a File or Volume-Id.
  110.  
  111.                         IMPORTANT -  Normal DOS conventions are not
  112.  
  113.                         necessarily followed as spaces in a name are allowed
  114.  
  115.                         but you may find that having those spaces can cause
  116.  
  117.                         problems.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                       -3-
  134.  
  135.  
  136.  
  137.                 ( b ) - Edit the file attribute.
  138.  
  139.                         Enter the correct decimal number for the desired
  140.  
  141.                         attribute.
  142.  
  143.                         Note: it is not reccommed to change these unless you
  144.  
  145.                         have an express purpose in mind. The following codes
  146.  
  147.                         in decimal apply:
  148.  
  149.  
  150.                                   01 = Read-Only file
  151.                                   02 = Hidden
  152.                                   04 = System
  153.                                   06 = hidden and System
  154.                                   08 = Volume-Id
  155.                                   16 = Sub-Directory
  156.                                   32 = Archive
  157.                                   39 = Read-Only,Hidden,System,Archive
  158.  
  159.                         Example: 1 + 2 + 4 + 32 = 39
  160.  
  161.  
  162.                 ( c ) - Edit Date-Stamp.
  163.  
  164.                         Enter the Month, Day, and Year or just enter
  165.  
  166.                         <return> to Quit. Changing the date-stamps for all
  167.  
  168.                         similar files can make them much easier to spot.
  169.  
  170.  
  171.                 ( d ) - Edit Time-Stamp.
  172.  
  173.                         Enter the Hours in 24 hour notation, the Minutes,
  174.  
  175.                         and Seconds or press <return> to return to menu.
  176.  
  177.  
  178.        OPTION ( 4 ) - Write Sorted Directory back to Disk.
  179.  
  180.            This option allows you to sort all the files except the two
  181.  
  182.            system files (IBMBIO.COM and IBMDOS.COM) and write them back to
  183.  
  184.            the disk in their new sorted order. If you choose this option
  185.  
  186.            you may answer YES or NO to the question of sorting on the label
  187.  
  188.            printing option.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                       -4-
  202.  
  203.  
  204.  
  205.        OPTION ( 5 ) - Read Next Disk or Change Disk Drive.
  206.  
  207.            Use this option to verify any changes you made to the disk or if
  208.  
  209.            you change Disks. Drives `A' and `B' should NOT be Hard Disks.
  210.  
  211.  
  212.        OPTION ( 6 ) - Change Disk Name.
  213.  
  214.            This option is used mainly for the title on your disk labels.
  215.  
  216.            So if you want to change the title on your new disk label then
  217.  
  218.            use this option before printing a label.
  219.  
  220.  
  221.  
  222.            NOTE: Also on any ERROR the program will automatically go to
  223.  
  224.                  this option. To determine what the error was may require
  225.  
  226.                  you to temporarily place a REM statement at the begining
  227.  
  228.                  of line 530. (On MS-BASIC version ONLY)
  229.  
  230.  
  231.        OPTION ( 7 ) - Change Date/Time.
  232.  
  233.            These are for the system date and time and should be set to
  234.  
  235.            insure any updates to your files will have the correct date and
  236.  
  237.            time mark. If not you may have files with a date of 1-1-80 and
  238.  
  239.            of course that is why I have written OPTION ( 3 ).
  240.  
  241.  
  242.        OPTION ( 8 ) - Print Disk Label.
  243.  
  244.            This option was written for the Epson Printers and may not work
  245.  
  246.            correctly on other brands.
  247.  
  248.            Line the Right Hand edge of the 4 x 1 7/16 Label Wax paper on the
  249.  
  250.            number 43 of the print bar and the print head on the bottom edge
  251.  
  252.            of the hole just above the label.
  253.  
  254.  
  255.        OPTION ( 9 ) - Add Volume-Id.
  256.  
  257.            Enter a maximum of 11 characters to add a new Volume-Id.
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                       -5-
  268.  
  269.  
  270.  
  271.  
  272.        NOTES:
  273.  
  274.            A. I felt it was a good idea to not sort the two system files
  275.  
  276.               (IBMBIO.COM AND IBMDOS.COM) but in the basic version of this
  277.  
  278.               program it is possible to change it so that ALL files will be
  279.  
  280.               sorted.
  281.  
  282.            B. Also I like to first name the Volume-Id `AAA' and choose
  283.  
  284.               option ( 4 ) to write the files back to disk, then afterwards
  285.  
  286.               rename the Volume-Id whatever name is approiate. This way the
  287.  
  288.               System files are always the first two files listed and the
  289.  
  290.               Volume-Id is the third.
  291.  
  292.  
  293.            C. This program is being distributed two ways, Compiled for
  294.  
  295.               speed and in Interpreted MS-BASIC for programmers who like to
  296.  
  297.               study and perhaps modify others source code. On the compiled
  298.  
  299.               version the first option will only display the basic programs
  300.  
  301.               for a given disk. It will not allow you to Load and Run them.
  302.  
  303.               The cost of the compiled program is $10.00 and the cost of the
  304.  
  305.               Interpreted MS-BASIC version is $19.95.
  306.  
  307.            D. The DOS function call that used to bomb on machines running
  308.               a 8086 or 80286 with the error "division by zero" has been
  309.               fixed.
  310.  
  311.            E. Any suggestions for improvement are welcome and invited.
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  Any suggestions for improvement are we